home *** CD-ROM | disk | FTP | other *** search
/ Nightshift Sound & Vision / Nightshift - Sound & Vision.iso / gfxmanager / docs / ppmquant.man < prev    next >
Text File  |  1994-03-01  |  2KB  |  133 lines
  1.  
  2.  
  3.  
  4.      ppmquant(1)          AMIGA (12 January 1991)          ppmquant(1)
  5.  
  6.  
  7.  
  8.      NAME
  9.           ppmquant - quantize the colors in a portable pixmap down to
  10.           a specified number
  11.  
  12.      SYNOPSIS
  13.           ppmquant [-floyd|-fs] ncolors [ppmfile]
  14.           ppmquant [-floyd|-fs] -map mapfile [ppmfile]
  15.  
  16.      DESCRIPTION
  17.           Reads a portable pixmap as input.  Chooses ncolors colors to
  18.           best represent the image, maps the existing colors to the
  19.           new ones, and writes a portable pixmap as output.
  20.  
  21.           The quantization method is Heckbert's "median cut".
  22.  
  23.           Alternately, you can skip the color-choosing step by
  24.           specifying your own set of colors with the -map flag.  The
  25.           mapfile is just a ppm file; it can be any shape, all that
  26.           matters is the colors in it.  For instance, to quantize down
  27.           to the 8-color IBM TTL color set, you might use:
  28.               P3
  29.               8 1
  30.               255
  31.                 0   0   0
  32.               255   0   0
  33.                 0 255   0
  34.                 0   0 255
  35.               255 255   0
  36.               255   0 255
  37.                 0 255 255
  38.               255 255 255
  39.           If you want to quantize one pixmap to use the colors in
  40.           another one, just use the second one as the mapfile.  You
  41.           don't have to reduce it down to only one pixel of each
  42.           color, just use it as is.
  43.  
  44.           The -floyd/-fs flag enables a Floyd-Steinberg error
  45.           diffusion step.  Floyd-Steinberg gives vastly better results
  46.           on images where the unmodified quantization has banding or
  47.           other artifacts, especially when going to a small number of
  48.           colors such as the above IBM set.  However, it does take
  49.           substantially more CPU time, so the default is off.
  50.  
  51.           All flags can be abbreviated to their shortest unique
  52.           prefix.
  53.  
  54.      REFERENCES
  55.           "Color Image Quantization for Frame Buffer Display" by Paul
  56.           Heckbert, SIGGRAPH '82 Proceedings, page 297.
  57.  
  58.      SEE ALSO
  59.           ppmquantall(1), pnmdepth(1), ppmdither(1), ppm(5)
  60.  
  61.  
  62.  
  63.      Page 1                                           (printed 3/1/94)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      ppmquant(1)          AMIGA (12 January 1991)          ppmquant(1)
  71.  
  72.  
  73.  
  74.      AUTHOR
  75.           Copyright (C) 1989, 1991 by Jef Poskanzer.
  76.  
  77.  
  78.  
  79.  
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.      Page 2                                           (printed 3/1/94)
  130.  
  131.  
  132.  
  133.